Informática Multimedia 1995 April

home *** CD-ROM | disk | FTP | other *** search

/ Informática Multimedia 1995 April / Informatica Multimedia CD - Epimundo.iso / DOS / CAT_DISK / DMS10.ZIP / DMS10.DOC < prev next >

Wrap

Text File | 1993-12-27 | 21.6 KB | 640 lines

▒▒▒▒▒▄ ▒▒▒▄▄▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒█▀▒▒█ ▒▒█▒▒█▒▒█ ▒▒█▀▀▀▀ ▒▒█ ▒▒█ ▒▒█ ▀▀▒▒█ ▒▒▒▒▒▒▄ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▀▀▀▒▒█ ▒▒▒▒▒█▀ ▒▒█ ▒▒█ ▒▒▒▒▒▒█ ▀▀▀▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀ Disk Management System Version 1.0 Jay Brown BC Systems 7801 Dublin Wichita, KS 67206 USA CIS: 73171,2442 Copyright 1993 by Jay Brown All rights reserved worldwide Contents Chapter 1 - General Information .............................. 1 Product Overview ........................................ 1 Shareware Marketing Concept ............................. 1 Software Use Agreement ................................. 2 Registration Information ................................ 3 Distribution Files ..................................... 3 Installation Procedure .................................. 4 Chapter 2 - Volume Operations ................................ 5 Cataloging a Disk Volume ................................ 5 Scratching a Volume ..................................... 5 Listing Volumes and Free Space .......................... 6 Chapter 3 - Groups ........................................... 7 Adding or Modifying a Group ............................. 7 Listing Groups .......................................... 7 Chapter 4 - File Operations .................................. 8 Adding or Moving a File ................................. 8 Deleting a File ......................................... 8 Updating the File Description ........................... 9 Updating the Group Assignment ........................... 9 Exporting the Catalog ................................... 9 Chapter 5 - Reporting ........................................ 10 Report by File Name ..................................... 10 Report by Group ......................................... 10 Report by Description .................................. 11 Report by Volume ........................................ 11 Report Unassigned Group ................................. 11 Chapter 6 - DMSIMP Utility ................................... 12 Chapter 7 - XDESC Utility .................................... 13 Chapter 1 General Information Product Overview DMS can help you organize your files and diskettes. The following features set DMS apart from other disk cataloging software: - Ease of use - Command line interface - Uses 4DOS descriptions if available - Optionally assigns categories to files - Generates reports based on filename, description, category or volume - Ability to move/copy files to free space on cataloged volumes - A low registration cost of $15 US A typical user will catalog a set of floppy diskettes, or volumes, by typing DMS -c at the DOS prompt. Each volume must first be labeled with the DOS label command, and inserted into the disk drive. To quickly find a file contained by one of these volumes, the user will type DMS filename The filename may contain DOS wildcards. DMS will then report all matching files and their volume label. To add a file to one of the cataloged volumes, simply type DMS -a filename DMS will select the first volume with sufficient space to hold the file or files and prompt for insertion of the disk. To generate a full catalog report by filename and send the report to the printer, the user will type DMS -r >prn A summary of command options is presented if you type DMS without any arguments. That's all there is to it, Have Fun!! Shareware Marketing Concept Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual. Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware. Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it. Software Use Agreement Users of DMS must accept this disclaimer of warranty: "DMS is supplied as is. The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of DMS." DMS is a "shareware program" and is provided at no charge to the user for evaluation. Feel free to share it with your friends, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using DMS and continue to use DMS after a reasonable trial period of 30 days, you must make a registration payment of $15 to Jay Brown. The $15 registration fee will license one copy for use on any one computer at any one time. You must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time. Anyone distributing DMS for any kind of remuneration must first contact Jay Brown at the address above for authorization. This authorization will be automatically granted to distributors recognized by the (ASP) as adhering to its guidelines for shareware distributors, and such distributors may begin offering DMS immediately (However Jay Brown must still be advised so that the distributor can be kept up-to-date with the latest version of DMS.). You are encouraged to pass a copy of DMS along to your friends for evaluation. Please encourage them to register their copy if they find that they can use it. Registration Information Simply print and fill out the order form supplied as file "ORDFORM.TXT". Send it and a $15 check or money order, drawn for US funds, and made payable to Jay Brown. You will receive free technical support by US Mail or E-Mail, Notice of future revisions, a printed copy of this documentation, and a license number. This activation number, in conjunction with your registration name, can be used to disable the shareware notices. Your number will be valid for all future releases of DMS. To enter your license number, once received, simply type the command: DMS -L You will be prompted for your name and activation number. You must enter your name exactly as it appears on the license confirmation letter. You may NOT distribute a licensed copy of DMS. Your name is displayed when the "DMS" command is issued without arguments. Distribution Files dms.exe Disk Management System executable dmsimp.exe Database import utility dms.dbd Database dictionary file_id.diz Software description desc.sdi Software description xdesc.exe 4DOS automatic description utility dms10.doc Documentation text file descript.ion 4DOS file descriptions ordform.txt DMS order form Installation Procedure Installation of DMS is much like any other software package. Refer to your DOS manual if you have any questions about modifying your PATH, setting environment variables or creating directories. 1. Create a directory of your choice. 2. Copy the executables and database dictionary to the directory you have just created. 3. Add the directory to your PATH. This is necessary if you wish to run DMS outside of it's directory. The PATH is used by DOS to find the executable and by DMS to find it's database. 4. If your floppy drive is not drive A, then set the DMSDRIVE environment variable. This can be done in your AUTOEXEC.BAT file similar to how the PATH is set (e.g. SET DMSDRIVE=B). Chapter 2 Volume Operations Cataloging a Disk Volume A new diskette can be added to the catalog with the command DMS -C The diskette must first be placed in the DMSDRIVE. The default drive is "A". However, to utilize another drive, simply set the DMSDRIVE environment variable. For example, if you are using drive "B" for your catalog activities, issue the following DOS command: "SET DMSDRIVE=B". This command may be added to your AUTOEXEC.BAT file. The diskette you are cataloging must also have a DOS label. This label must uniquely identify the diskette among your other cataloged disks. For example, to label your disk as "SHARE0001", simply issue the DOS command "label a:", assuming your DMSDRIVE is "A", and respond with "SHARE0001" when asked for the label. You may use up to eleven characters. If the files on the diskette have 4DOS descriptions, these descriptions will be stored in the catalog. Refer to the 4DOS "describe" command or the XDESC utility in Chapter 7. Each file on the diskette may also be associated with a group or category of files. The group numbers must have already been setup, refer to Chapter 3 for a discussion on using groups. The 4DOS description may optionally specify the file's associated group. This is done by placing the group number followed by a slash as the first part of the file's description. For example, PANELC24.ZIP 2/Panels for C user interface indicates the file "PANELC24.ZIP" should belong to group number 2, and it's description should be "Panels for C user interface. Scratching a Volume To remove a volume or diskette from the catalog, simply issue the command DMS -S SHARE0001 This command will remove the volume SHARE0001 from the catalog along with all the file entries contained by the volume. This command will not alter the actual contents of the diskette. It will only uncatalog the diskette. Listing Volumes and Free Space The command DMS -V will list to stdout all the volumes that have been previously cataloged. This command will also display the free space (in bytes) on each volume. This information can be easily printed with DMS -V >PRN or redirected to a text file, refer to your DOS manual. Chapter 3 Groups Groups allow you to categorize your files without regard to the volumes they are contained. A group consists of a number and a name and associated catalog files. You may have up to 999 groups. Adding or Modifying a Group The command DMS -G3 will allow you to add group number three, if it does not already exist. Otherwise, it will allow you to modify the group name. Listing Groups The command DMS -G or DMS -GN will list all the defined groups by group number. Output from this command might look like this: 1 Archivers 2 BBS Software 3 Business 4 DOS Shells/Menus 5 Educational 6 Utilities 7 Ham Radio 8 Household 9 OS/2 10 Programming 11 Windows 12 Database 13 Clip Art 14 Security 15 Telecommunications 16 Graphics 17 Misc. 18 Fonts and Managers Also, the command DMS -GD will list all the defined groups by group name, or description. Chapter 4 File Operations Adding or Moving a File A file may be copied or moved onto the catalog disk set. These operations will physically copy/move the specified file to a cataloged diskette with enough space to hold the file. The move operation will delete the specified file after successfully copying it to a cataloged disk. Upon successful copy/move the catalog database is updated to reflect the new file name, description, group, etc. The volume free space is also updated. For example, DMS -A PANELC24.ZIP will search for a cataloged volume with enough space to hold the file, prompt you to insert the volume, and perform the copy. The 4DOS description is used to update the catalog information about this new file, if available. DMS -M ABC110.ZIP will perform the same steps as the previous example, in addition to removing the file after the copy is performed. DMS -A3 AB*.ZIP PANELC*.* This example illustrates the use of wildcards. Also, the newly cataloged files will be associated with group number 3. The group association may also be specified within the 4DOS description as follows: DESCRIBE PANELC24.ZIP "4/Panels for C user interface" This would indicate PANELC24.ZIP belongs to group number 4 while all other files matching the wildcards belong to group 3. Deleting a File A file may be physically removed from its associated volume by issuing the "-d" option. Wildcards are also permitted. The catalog database is updated to reflect the deleted files. For example, DMS -D ABC110.ZIP will search the catalog database for the file, remove the database entry, prompt for insertion of the appropriate volume and delete the file from the inserted diskette, if actually present. Updating the File Description File descriptions may be updated within the catalog database. This option does not alter the 4DOS description. For example, DMS -P"Accounting file" AB*.* will update all cataloged files beginning with "AB" to have the description of "Accounting file". Updating the File Group Assignment Files may be assigned or reassigned to groups within the catalog database. For example, DMS -5 AB*.* will update all cataloged files beginning with "AB" to be associated with group number 5, regardless of their previous association. Exporting the Catalog A command option is available allowing exportation of all file information in String Delimited Format (SDF). This is useful if you wish to import the disk catalog into a spreadsheet, or other software product. DMS -E >FILES.SDF This will essentially dump the catalog database to the file "FILES.SDF". The fields on each line are as follows: file name, size, date, time, attributes, description, volume label, volume free space, group number, and group name. Chapter 5 Reporting Report by File Name The command DMS -R or DMS -RF may be issued to list all files in the catalog, sorted by filename. The following is an example of how this report might look: 200ICONS.ZIP 41160 01/16/92 --- Icons for Windows 2DOV10.ZIP 812625 04/26/93 11 To-do task manager 4DMENU11.ZIP 9472 10/28/92 --- 4DOS401D.ZIP 258944 10/27/92 --- 4DOS401P.ZIP 289920 10/27/92 --- 4EDIT105.ZIP 33280 10/28/92 --- 4MICA25A.ZIP 12288 03/22/93 --- 4OS210.ZIP 255232 10/28/92 --- 4PROMPT.ZIP 6784 10/27/92 --- 4WIN110.ZIP 39789 07/04/91 11 4-DOS like shell for Windows Also listed are the file size, file date, group number (if assigned) and file description. Report by Group The command DMS -RG may be used to list all files in the catalog which are associated with a group. The following is an example of how this report might look: Archivers --------------------------------------- AM97.ZIP 219108 10/23/93 ArcMaster V9.5 SHEZ94.ZIP 252170 10/14/93 SHEZ V9.4 Compression Shell BBS Software --------------------------------------- BIN2ASC1.ZIP 16647 11/02/93 Convert binary to text CQWK110A.ZIP 391223 11/02/93 Windows offline mail reader #1 CQWK110B.ZIP 404221 11/02/93 Windows offline mail reader #2 SLMR21A.ZIP 160065 11/10/93 Silly Little Mail Reader Report by Description The command DMS -RP may be used to report all files sorted by description prose. An example might look like this: 4-DOS like shell for Windows 4WIN110.ZIP 39789 07/04/91 4DOS aware zip and unzip utility ZIP4.ZIP 51238 11/22/93 4DOS front-end for ROBOCOMM AUTOROB2.ZIP 7484 11/03/93 Address manager for windows ADR11B.ZIP 222411 03/05/93 Antique font for Windows ANTIQUE.ZIP 37724 01/14/91 Archive shell SHEZ90A.ZIP 234112 06/08/93 ArcMaster V9.5 AM97.ZIP 219108 10/23/93 Report by Volume The command DMS -RV will report all files in the catalog sorted by volume label. An example follows: SHARE0001 ----------- AC44A0.ZIP 61195 10/20/91 Painless accounting for Windows #1 of 2 DIARY.ZIP 37632 04/14/90 SLM.ZIP 35461 04/05/92 Shopping list manager SHARE0002 ----------- DRAGVIEW.ZIP 259705 08/05/93 Drag and View for Windows TDRAWFNT.ZIP 17048 11/09/93 Fonts for THEDRAW WPGR.ZIP 928256 06/29/93 WPG clip art Report Unassigned Group The command DMS -RU will list for you all the catalog files not assigned to a group. An example follows: 200ICONS.ZIP 41160 01/16/92 Icons for Windows AGWP-P.ZIP 34807 03/21/93 Wet Paint font for Windows ANSIDR30.ZIP 22272 07/11/90 ANTIQUE.ZIP 37724 01/14/91 Antique font for Windows BDSK22.ZIP 57922 01/16/92 BEAV120.ZIP 70016 11/02/92 Binary editor and viewer BTOOL1.ZIP 132352 11/04/92 C library for BTrieve access Chapter 6 DMSIMP Utility The DMSIMP utility is basically the opposite of the export command option. This utility program may be used to recreate your catalog database from an export file, combine multiple databases, or populate the catalog database created from some other software product. The format must match that generated from the export command option. For example, DMSIMP FILES.SDF will import the files specified within the file "FILES.SDF" into the catalog database. The file must contain valid String Delimited Format (SDF) records. The fields are as follows: file name, size, date, time, attributes, description, volume label, volume free space, group number, group name. Information within the database will not be removed. To first clear the contents of your catalog database, simply delete all data and index files from your DMS directory. The following DOS command may be used: DEL DMS0*.* Chapter 7 XDESC Utility A utility is included to automattically populate the 4DOS description for ZIP files. Shareware authors usually include either "FILE_ID.DIZ" or "DESC.SDI" within their distribution archives. These files, if present, are utilized to describe the archive file. If neither of these files is found within the archive, a ROBOCOMM comment is utilized, if available. When the ROBOCOMM software system is used to obtain the archive file, an archive comment may have been inserted. The command line format is as follows: XDESC [-S] [-Gn] FILE1 [FILE2 ...] The "-S" option is used to create short descriptions, as needed by DMS. The "-G" option may be used to include a group number within the description. The files may be specified using wildcards. If a file is already described, it will be skipped. A file will not be re-described by this utility. For example, XDESC -S -G2 *.ZIP will create 4DOS descriptions for all ZIP files in the current directory, which do not already have descriptions. The description will be limited to 40 characters due to the "-S" option. A "2/" will be included in each description.